home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 3 / Amiga Tools 3.iso / grafik / raytracing / makehaze / makehaze.doc < prev    next >
Encoding:
Text File  |  1995-09-28  |  6.1 KB  |  171 lines
  1. ####################################################################
  2. #                                                                  #
  3. #      makeHaze v0.8 (28 September 1995) - ©1995 by A.Maschke      #
  4. #                                                                  #
  5. ####################################################################
  6.  
  7. CONTENTS
  8.  
  9. 1. Introduction
  10. 2. Requirements
  11. 3. Command-line-options
  12. 4. Examples
  13. 5. Author/Registration
  14. 6. History/TODO
  15.  
  16. 1. Introduction
  17. --------------------------------------------------------------------
  18.  
  19.  This program operates on 24Bit-ILBM-pictures to create a
  20.  haze-like-effect. Imagine features such an operator
  21.  called "haze" as global-F/X . This module works fine on single
  22.  images - but it is too slow for animations. So I tried to
  23.  create my own haze-effect. The result is the programm makeHaze.
  24.  It features no antialiasing but has better region-control than
  25.  Imagine's "haze". It's faster, of course.
  26.  
  27.  Summary:
  28.   Advantages:    - high speed
  29.                  - good quality for animations
  30.                  - colors can be locked for the effect, this makes
  31.                    it possible to create haze-effects on overlapping
  32.                    objects
  33.                  - all clusters found in the image are processed
  34.                    separately pass by pass
  35.                  - image-composing/post-F/X using other software possible
  36.   Disadvantages: - no antialiasing
  37.  
  38. NOTE: You may ask: What are clusters ?
  39.       All regions of pixels which have the same color and are connected
  40.       by at least one point build one cluster.
  41.       (That means that three seperate red lamps are detected as
  42.        three separate clusters which are processed separately.)
  43.  
  44.       ((The word "cluster" is taken from the Solid State Physics,
  45.         Cu-Atoms on a Fe-surface build "clusters".))
  46.  
  47. 2. Requirements
  48. --------------------------------------------------------------------
  49.  *TURBO-version (program "makeHaze")
  50.    -MC68030+ and MC68881+
  51.    -ixemul.library V41+ (supplied)
  52.    -iff.library V23+ (supplied)
  53.    -enough memory
  54.  
  55.  *SLOW-version (program "makeHaze.slow")
  56.    -iff.library V23+ (supplied)
  57.    -enough memory and MHz
  58.  
  59.  
  60.  *memory-consumption:
  61.    normal mode: width*height*2*(3)          + (width*height*3)
  62.      fast mode: width*height*2*(clusters+1) + (width*height*3)
  63.                 (clusters)                    (chunky pixels)
  64.  
  65. 3. Command-line-options
  66. --------------------------------------------------------------------
  67.  
  68.        Usage: makeHaze <in> <out> <red> <green> <blue> .
  69.      Options: -lines <val>         (3<=val<=100)
  70.               -intensity <val>     (0.0<val<1.0)
  71.               -fast
  72.               -onecluster
  73.               -mergeclusters <val> (0<=val<=36)
  74.               -clearimage
  75.               -keep <val> <val rgb-vectors>
  76.               -clearimage
  77.  
  78.  Description: -<red>, <green>, <blue> specify the color which is to search
  79.  
  80.               -lines specifies the thickness of the haze
  81.                (good values 10..40)
  82.  
  83.               -<intensity> specifies the base-color of the haze:
  84.                 (<red> <green> <blue>)*<intensity>
  85.                (0.2..0.5 are good values)
  86.  
  87.               -<fast> turns on drastical speedup, requires much more
  88.                memory
  89.  
  90.               -<onecluster> merges all clusters, usefull if you have no
  91.                memory and no time
  92.  
  93.               -<mergeclusters> merges all clusters which contain less points
  94.                than <val>
  95.  
  96.               -<clearimage> causes the program to clear the whole image
  97.                before drawing the haze, this makes it possible to
  98.                apply some post-F/X (e.g. blur) to the haze
  99.  
  100.               -the <keep>-parameter is an very useful feature,
  101.                pixels which have one of the specified colors
  102.                are not changed. This allows to create haze-effects
  103.                on overlapping objects, such as a rotating lightball.
  104.  
  105.      Example: makeHaze pic pic2 255 0 0 -keep 2 0 255 0 0 0 255 -fast
  106.               ('Search the color red in picture "pic", create
  107.                picture "pic2", keep all pixels which have one
  108.                of the two colors green or blue')
  109.  
  110. 4. Examples
  111. --------------------------------------------------------------------
  112.  
  113.  a) pic.noHaze    - source-picture containing some "bright" objects
  114.  
  115.  b) pic.Imagine   - result of three haze-passes using Imagine
  116.  
  117.  c) pic.makeHaze  - result of three haze-passes using makeHaze
  118.                     (the blue color was locked for the green haze)
  119.  
  120.  Time-comparison (all 3 passes, Imagine without rendering):
  121.   Imagine  : 558s (9mins 18secs)
  122.   makeHaze : 70s (1min  10secs) (fast mode)
  123.  
  124.  d) pic.lightBall - one frame of a lightball-animation
  125.  
  126. NOTE: Don't use one of the supplied pictures to test the
  127.       program because all pictures where compressed using
  128.       JPEG. (The read beam in "pic.noHaze" has not the
  129.       color 255 0 0.)
  130.  
  131.  
  132. 5. Author/Registration
  133. --------------------------------------------------------------------
  134.  The makeHaze-package belongs to the Dust-project, to get
  135.  registered send $25+postage to the author:
  136.  
  137.                          Andreas Maschke
  138.                          Zenkerstraße 5
  139.                          06108 Halle/Saale
  140.                          Germany
  141.  
  142.                    Phone: ++49 (0)345/5170331
  143.                    EMail: epgbc@cluster1.urz.Uni-Halle.DE
  144.  
  145.  The following programs belong to the Dust-project
  146.   Dust (recent version: 2.31)
  147.   DustMD
  148.   Mesh2TDDD
  149.   makeHaze
  150.  
  151.  IF YOU PAID FOR ONE OF THIS PROGRAMMS YOU ARE REGISTERED
  152.  FOR ALL OTHERS IN THIS LIST.
  153.  
  154. 6. History/TODO
  155. --------------------------------------------------------------------
  156.  
  157. History
  158.  v0.1 (19 September 1995) - slow, ugly results
  159.  v0.2 (20 September 1995) - fast, better results, keep-option
  160.  v0.3 (21 September 1995) - speed-factor 2
  161.  v0.5 (26 September 1995) - new options <fast>, <oneCluster>, <mergeclusters>
  162.                             drastical speedup, some bugs removed
  163.  v0.8 (28 September 1995) - cluster-recognition improved (works fine on complicated objects like lines, circles, ...),
  164.                             program needs less memory,
  165.                             more speed,
  166.                             "elapsed-time"-info
  167. TODO
  168.  -program works fine for my purposes (lightballs) - nothing to do
  169.  
  170. (28 September 1995)
  171.